Inside Macintosh: QuickDraw GX Objects /

Chapter 4 - Colors and Color-Related Objects / Colors and Color-Related Objects Reference

Color Profile Functions / Creating and Manipulating Color Profile Objects

GXGetDefaultColorProfile

You can use the GXGetDefaultColorProfile function to obtain a reference to the default color profile object.

gxColorProfile GXGetDefaultColorProfile(void);

function result

A reference to the default color profile.

DESCRIPTION

The default color profile is the color profile for the Apple 13-inch color monitor. When converting or matching colors, QuickDraw GX assumes the default color profile for any color, bitmap, or transfer mode whose color profile property is nil.

Note that the return value of this function is a reference to the actual default color profile object, not a copy of it. You should not make changes to the profile; if you edit it (for example, by calling GXLockProfile and GXGetProfileStructure), you alter the actual default profile that QuickDraw GX uses when creating new color profile objects.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory

SEE ALSO

The default color profile object is discussed in the section "The Default Color Profile" beginning on page 4-37.

To create a copy of the default color profile object, you can use the GXCopyToColorProfile function, described on page 4-81.

To create a new color profile, use the GXNewColorProfile function, described next.